home *** CD-ROM | disk | FTP | other *** search
/ Developer CD Series 1992 June: ROMin Holiday / ADC Developer CD (1992-06) (''ROMin Holiday'')_iso / Developer Connection - 06-1992.iso / Development Platforms / A⁄UX Related / A⁄UX Debugger (dbx) / Read Me < prev   
Encoding:
Text File  |  1991-07-02  |  2.3 KB  |  50 lines  |  [TEXT/ttxt]
  1. DBX for A/UX v3.7 Release Notes
  2. -----------------------------
  3. Version 3.7 of dbx is a beta-release of the 4.3 BSD symbolic debugger dbx.  This version has been adapted to understand the A/UX symbol table format (COFF) and to provide support for the debugging of A/UX Toolbox hybrid applications.  
  4.  
  5. Contents
  6. --------
  7.     dbx    - version 3.7 for A/UX
  8.     dbx.1    - manual page
  9.     newunix    -    A/UX 2.0.1 kernel module (needed to support debugging of hybrid apps) 
  10.  
  11. Installation
  12. -----------
  13. To install dbx you must be super-user (either login as root, or become root with su)
  14. and do the following:
  15.  
  16. 1. copy dbx to /usr/ucb/dbx
  17. 2. copy dbx.1 to /usr/catman/u_man/man1/dbx.1
  18.  
  19. If you want to debug hybrid applications, you will need a new A/UX 2.01 kernel.  To build and install a new kernel do the following:
  20.  
  21. 3. copy /etc/config.d/newunix /etc/config.d/newunix-
  22. 4. copy /unix /unix-
  23. 5. copy newunix /etc/config.d
  24. 6. run the command newconfig (see newconfig(1))
  25. 7. reboot
  26.  
  27. Debugging Hybrid Applications
  28. ---------------------------
  29. After building the new A/UX kernel, dbx can be used to debug hybrid applications.  Hybrid applications are A/UX COFF binaries that make toolbox traps.  For example,
  30. the A/UX CommandShell is a hybrid application.
  31.  
  32. To debug hybrid applications it is necessary to run the debugger from an external terminal.  The external terminal may be another Unix system connected by the ethernet (via telnet or rlogin) or a terminal on a serial line.
  33.  
  34. An Important Note on the A/UX Toolbox
  35. -----------------------------------
  36. A/UX uses Unix signals heavily in its emulation of the Macintosh toolbox.  In particular, SIGIOT is used to emulate VBL tasks, SIGIO and SIGURG are both used in the completion routines for A/UX AppleTalk.  When you debug hybrid applications, you will want this signals to not be caught by the debugger.  In dbx, to prevent the catching of these
  37. signals, use the following command:
  38.                                                                             ignore SIGIOT SIGIO SIGURG
  39.  
  40. Known Problems
  41. ---------------
  42. - Dbx does not handle floating point registers.
  43. - Doing a 'next' at the entry of a function will cause dbx to exit the function being debugged.  A work around is to do a 'step' followed by a 'next'.
  44. - The 'trace in <procedure>' command does not behave correctly.
  45.  
  46.  
  47. New Versions
  48. ------------
  49. New versions of dbx will be placed on the Internet host aux.apple.support.com (130.43.6.2).
  50.